<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Apache Maven 安装指南</title>
    <link rel="preconnect" href="https://fonts.googleapis.com">
    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
    <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;700&family=Merriweather:wght@700&family=IBM+Plex+Mono&display=swap" rel="stylesheet">
    <style>
        body {
            font-family: 'Inter', sans-serif;
            color: #333333; /* 深色文字 */
            background-color: #f8f9fa; /* 浅灰背景 */
            margin: 0;
            padding: 20px;
            line-height: 1.7;
            position: relative;
            min-height: 100vh;
        }
        body::before {
            content: "";
            position: fixed;
            top: 0;
            left: 0;
            width: 100vw;
            height: 100vh;
            background-image: 
                linear-gradient(rgba(0,0,0,0.02) 1px, transparent 1px),
                linear-gradient(90deg, rgba(0,0,0,0.02) 1px, transparent 1px);
            background-size: 25px 25px; /* 网格大小 */
            z-index: -1;
            opacity: 0.7;
        }
        .container {
            max-width: 800px;
            margin: 40px auto; /* 页面居中和留白 */
            padding: 30px 40px;
            background-color: #ffffff; /* 内容区域白色背景 */
            border: 1px solid #e0e0e0; /* 细边框 */
            border-radius: 8px; /* 适中圆角 */
            box-shadow: 0 4px 12px rgba(0,0,0,0.08); /* 微妙阴影 */
        }
        h1, h2, h3, h4, h5, h6 {
            font-family: 'Merriweather', serif; /* 标题衬线字体 */
            font-weight: bold;
            color: #1a1a1a; /* 标题深色 */
            margin-top: 1.8em;
            margin-bottom: 0.8em;
            line-height: 1.3;
        }
        h1 {
            font-size: 2.6em; /* 大字号 */
            border-bottom: 2px solid #eeeeee;
            padding-bottom: 0.3em;
        }
        h2 {
            font-size: 2em;
            border-bottom: 1px solid #f0f0f0;
            padding-bottom: 0.2em;
        }
        h3 {
            font-size: 1.6em;
        }
        p {
            margin-bottom: 1.2em;
        }
        a {
            color: #3b82f6; /* 强调色：明亮蓝色 */
            text-decoration: none;
            font-weight: 500;
        }
        a:hover {
            text-decoration: underline;
        }
        ul, ol {
            padding-left: 25px;
            margin-bottom: 1.2em;
        }
        li {
            margin-bottom: 0.6em;
        }
        pre {
            font-family: 'IBM Plex Mono', monospace; /* 代码等宽字体 */
            background-color: #282c34; /* 深色代码块背景 */
            color: #abb2bf; /* 代码块文字颜色 */
            padding: 18px;
            border-radius: 6px;
            overflow-x: auto;
            font-size: 0.9em;
            line-height: 1.5;
            border: 1px solid #3a3f4a;
        }
        code {
            font-family: 'IBM Plex Mono', monospace; /* 代码等宽字体 */
            background-color: #e9ecef; /* 内联代码浅灰背景 */
            color: #c7254e; /* 内联代码颜色 */
            padding: 0.2em 0.4em;
            border-radius: 4px;
            font-size: 0.85em;
        }
        strong, b {
            font-weight: 700; /* 粗体 */
        }
        em, i {
            font-style: italic;
        }
        img {
            max-width: 100%;
            height: auto;
            border-radius: 4px;
            margin-top: 0.5em;
            margin-bottom: 0.5em;
        }
        /* 响应式设计 */
        @media (max-width: 768px) {
            .container {
                margin: 20px auto;
                padding: 20px;
            }
            h1 { font-size: 2.2em; }
            h2 { font-size: 1.8em; }
            h3 { font-size: 1.4em; }
            body { padding: 10px; }
        }
    </style>
</head>
<body>
    <div class="container">
        <h1>Apache Maven 安装指南</h1>
<p>在 Windows 10 或 Windows 11 系统上安装 Apache Maven。</p>
<h2>1. 前提条件</h2>
<p>在安装 Maven 之前，请确保您已经正确安装了 Java Development Kit (JDK)，因为 Maven 是基于 Java 运行的。您可以参考 <a href="./安装jdk.html">jdk安装.md</a> 文档进行 JDK 的安装和验证。</p>
<h2>2. 下载 Apache Maven</h2>
<ol>
<li>访问 Apache Maven 的官方下载页面：<a href="https://maven.apache.org/download.cgi">Apache Maven Downloads</a></li>
<li>在 &quot;Files&quot; 部分，下载最新的 &quot;Binary zip archive&quot;，例如 <code>apache-maven-x.x.x-bin.zip</code> (其中 <code>x.x.x</code> 是版本号)。</li>
<li>可以直接下载 Apache Maven 3.9.9 版本：<a href="https://dlcdn.apache.org/maven/maven-3/3.9.9/binaries/apache-maven-3.9.9-bin.zip">apache-maven-3.9.9-bin.zip</a></li>
</ol>
<h2>3. 安装 Apache Maven</h2>
<p>Maven 的安装主要是解压下载的压缩包到您选择的目录。</p>
<ol>
<li>选择一个合适的安装目录。推荐的目录是 <code>C:\Program Files\apache-maven-x.x.x</code> 或 <code>D:\tools\apache-maven-x.x.x</code> (请将 <code>x.x.x</code> 替换为您下载的实际版本号)。</li>
<li>将下载的 <code>apache-maven-x.x.x-bin.zip</code> 文件解压到您选择的安装目录。
例如，如果您选择 <code>C:\Program Files\</code> 作为父目录，解压后 Maven 的主目录将是 <code>C:\Program Files\apache-maven-x.x.x</code>。</li>
</ol>
<h2>4. 配置环境变量</h2>
<p>为了在任何路径下都能运行 Maven 命令，您需要配置以下环境变量：</p>
<h3>4.1 设置 M2_HOME 和 MAVEN_HOME 环境变量</h3>
<p><code>M2_HOME</code> 是 Maven 2 及以后版本推荐使用的环境变量名，而 <code>MAVEN_HOME</code> 是一些旧工具或脚本可能使用的变量名。为了兼容性，建议同时设置它们。</p>
<ol>
<li>在 Windows 搜索栏中搜索“环境变量”，然后选择“编辑系统环境变量”。<br>
<img src="../images/设置环境变量.png" alt="设置环境变量"></li>
<li>在“系统属性”对话框中，点击“环境变量(N)...”按钮。</li>
<li>在“环境变量”对话框的“系统变量(S)”部分：
<ul>
<li>点击“新建(W)...”。
<ul>
<li>变量名(N): <code>M2_HOME</code></li>
<li>变量值(V): <code>C:\Program Files\apache-maven-x.x.x</code> (替换为您的实际 Maven 安装路径)</li>
</ul>
<img src="../images/新增系统变量.png" alt="新增系统变量"></li>
<li>再次点击“新建(W)...”。
<ul>
<li>变量名(N): <code>MAVEN_HOME</code></li>
<li>变量值(V): <code>C:\Program Files\apache-maven-x.x.x</code> (替换为您的实际 Maven 安装路径)</li>
</ul>
</li>
</ul>
</li>
<li>点击“确定”保存。</li>
</ol>
<h3>4.2 更新 Path 环境变量</h3>
<ol>
<li>在“系统变量(S)”中，找到并选中名为 <code>Path</code> (或 <code>PATH</code>) 的变量，然后点击“编辑(E)...”。</li>
<li>在“编辑环境变量”对话框中，点击“新建(N)”，然后添加以下条目：
<pre><code>%M2_HOME%\bin
</code></pre>
或者，如果您更倾向于使用 <code>MAVEN_HOME</code>：
<pre><code>%MAVEN_HOME%\bin
</code></pre>
</li>
<li>确保这个新条目在列表中的位置（如果需要，可以使用“上移(U)”或“下移(D)”按钮调整顺序，但通常添加到末尾即可）。</li>
<li>点击“确定”保存所有打开的对话框。</li>
</ol>
<p><strong>注意</strong>: 修改环境变量后，您可能需要重新启动命令提示符、PowerShell 或您的计算机才能使更改生效。</p>
<h2>5. 验证安装</h2>
<p>打开新的命令提示符 (CMD) 或 PowerShell 窗口，然后执行以下命令来验证 Maven 是否已成功安装并且环境变量配置正确。</p>
<h3>5.1 验证 Maven 版本</h3>
<p>输入以下命令：</p>
<pre><code>mvn -version
</code></pre>
<p>或者</p>
<pre><code>mvn --version
</code></pre>
<p>如果安装成功，您将看到类似以下的输出，显示 Apache Maven 的版本信息、Maven 的安装路径 (Maven home)、Java 版本以及操作系统信息：</p>
<pre><code>Apache Maven 3.9.6 (bc0240f3c744dd6b6ec2920b3cd08dcc295161ae)
Maven home: C:\Program Files\apache-maven-3.9.6
Java version: 1.8.0_xxx, vendor: Amazon.com Inc., runtime: C:\Program Files\Amazon Corretto\jdk1.8.0_xxx\jre
Default locale: zh_CN, platform encoding: GBK
OS name: &quot;windows 10&quot;, version: &quot;10.0&quot;, arch: &quot;amd64&quot;, family: &quot;windows&quot;
</code></pre>
<p>(具体的版本号、路径和 Java 信息会根据您的实际安装和配置而有所不同)</p>
<h3>5.2 检查 M2_HOME/MAVEN_HOME 环境变量</h3>
<p>在命令提示符 (CMD) 中输入：</p>
<pre><code>echo %M2_HOME%
</code></pre>
<p>或者在 PowerShell 中输入：</p>
<pre><code>$env:M2_HOME
</code></pre>
<p>输出应该是您在前面步骤中设置的 Maven 安装路径。</p>
<h3>5.3 检查 Path 环境变量中是否包含 Maven 的 bin 目录</h3>
<p>在命令提示符 (CMD) 中输入：</p>
<pre><code>echo %Path%
</code></pre>
<p>或者在 PowerShell 中输入：</p>
<pre><code>$env:Path
</code></pre>
<p>检查输出中是否包含指向 Maven <code>bin</code> 目录的路径 (例如 <code>C:\Program Files\apache-maven-x.x.x\bin</code>)。</p>
    </div>
</body>
</html>